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CIWTEE 1 


GBiERAL INfDWATICW 


la MlTOUCriCM 

Blis nanual describes the debi^gir^ lonitor TMbi^ as it is used in the VME/10 
Microcompoter System, hereafter referred to as the VME/lOc 


1.2 DEFINITI® OF Tfflbrg 

TENbug is the resident firaware debi^gir^ package for the VME/10. The 16K~byte 
fimwre (stored in tw 8Kx8 RCM or EPRM devices) provides a self-contained 
pr^ramiir^ arid operatir^ envirorment. TMbijq interacts with the user throiqh 
predefined ccmarrfs that are entered via the terminal . The conitiands fall into 
five general cat^oriess 

a® Coimar^s ^ich allow the user to display or nwdify menory® 

b. Goimiarris irfiich allow the user to display or irodify the various internal 
registers of the MC68010® 

c® Comands ^ich allow the user to execute a program under various levels 
of control. 

d. Conmarris which control access to the various input/output resources on 
the toard. 

e® Coimands i*iich allow the user to select video graphics resolution® 


M additional f met ion called the TRAP #15 
to utilize various routines within TENbug. 
r 5 ® 


I/O handler allo» the user pri^ram 
Hie raAP #15 handler is discussed in 


Itie o|»rational node of TQIbuq is descrited in Qiapter 2. 


1.3 TQfcug INTEHIAL STRUCTORE 
1.3.1 Bfei!»ry top 

Hie followir^ afctoreviated menory map for the VME/10 highlights addresses that 
might te of articular interest to users® Refer to the WK/10 

Microcanputer Systaii Overview Pfanual for a complete description of the iwory 
maps for toth high- and noriBl-resoliitiori graphics nodes® 

Itote that addresses are asstn^d to be hexadecimal throughout this nanual. In 
text, nwters may be preceded with a dollar sign {$) for identification as 
hecadecisal ® 


1~1 


RM LOmTICM 


Et«criM 


0~3FF 

400-M'F 

Vectors 

W 3 rk area and stack for TMbi^ 


SPECIAL LOIATIMS 

FUlCTim 


f!)0000“F00007 

Area containir^ initial values for su^rvisor stack 
p 3 inter^ program counter^ a«3 vector base register after 
cold start 

F14000-F14FFF 

Area used to define pr^graroMble **soft 

" character set 

I/O LKATI« 

EWCTICW 


F1C1C9 

FICICB 

FICIEI 

F1C1E9 

FlCODl 

Serial ^rt 2 (host) ^ serial I/O card (optional) 
ferial EX3rt 3 (host) , serial I/O card (optional) 

Parallel ^rt 1 (printer ) , parallel I/O card (optional) 
parallel port 2 (printer) ^ parallel I/O card (optional) 
Base address of Disk Controller 


1®3«2 Vectors a«a Errors 

TQIbog shares resources with the target program urrier test -- that is^ each 
affected resource can te used only by TENbog or the target program at any given 
tiii»® 


Exception vectors are PMiory locations from ^ich the processor fetches the 
address of a routine #iich will harrfle the exception. 'ttiese vectors are 
initialized by TMbijg in default i!M»ry locations 0 throiqh $3FF durir^ a cold- 
or warm-start sequence (see Oiapter 2) . If the target program uses any of these 
locations^ the user values must te rewritten foilowir^ each cold or warm start. 
If the target program uses any of the following locations^ the associated 
fimction will be lost to 

LQCATim TOtouq FUNCTICl^ 

10-13 
24-27 
K-BF 
138-13B 


Break^ints (illegal instructions) 
Trace 

TRAP #15 user calls to TMbug 
MOTT pushbutton switch on VME/10 


operator panel (see 


ttie vectors with default maiery locations of $80 through $3FF cause a ???? TOAP 
rareiR iKssage to te display^ on the console terminal. In addition^ several of 
the vectors cause display of a^ropriate information® (Refer to A^»ndix B for 
a list of error Kssages.) BUS arrf ADm trap errors also cause display of the 
exception status fraa the stacks in hexadecimal characters ir as shoMi in the 
followir^ exaiple. 


1-2 


Status Register 

Prog ran Counter Mdress 

Fraie Fomat and Vector Offset 

I Si^cial Status M>rd 

I 1 

I I Fault Mdress 


2709 00F0533A 8008 1305 00F1C030 0000 0020 0000 20FF OOFO 2007 067A 
5338 0000 OOFl 2007 C030 OOTO 533C FFEl 0000 0394 1E14 0000 0004 1E14 0003 

BUS TRAP ERTOR 


For additional information on this display^ refer to the bus error^ address 
error, a«3 the reference classification descriptions in the exception processing 
chapter of the fC68010 16-Bit Virtual Marory Microprocessor product 
specification hardtooke 


1«3«2«1 Resetting Vector Base Register . Hie MC68010 processor uf»n which the 
VM^IO is tosed features a vector Base Register (VBR) which contains the base 
(startir^) address for the VME/10 exception vectors. Exception vectors are 
locate in m«!»ry addresses 0 throi^h $3FF relative to the VBR. UpDn reset 
(cold or warm start) of the FC68010, the value of the VBR is set to zero® 

TEItoiq must have control of the exception vectors to function properly® If the 
user sets the VBR to a value other than its default value of zero, he must also 
establish a new set of exception vector roenory locations for the VBR value® In 
other wrds, the user must copy all existirq vector roeirory locations to the sane 
relative location in the new VBR table® 

In the following example, the VBR value is changed from 0 to 10F00-® Exception 
vector meKory locations must also te copied to this new location® itote that the 
content of each vector menory location the appropriate routine address) 
refrains the saitte® 


Vm = 0 VBR = lOFOO 


0 

00000444 


00000444 1 

4 


10Fp4 



0000044C 


0000044C 1 

8 


10F08 



00000454 


00000454 

C 







J S' 

3PC 


112FC 



000008A4 


000008A4 













TMbug prm/ides limits su^»i:t of disk I/O through a Wirrchester Disk 
Controller® Tte coMarils sup^rtrf are BH ard TO® Each of these camiarris does 
a read of tte volme ID foute on ¥ERSMos sector 0® 


Tte first 256K bytes of tte m^ia are tte voline ID® Bytes $F8-$FF of the 
voline ID must contain tte A^II character strir^. ”EXORMM:s”j otherwise^ an 
error n^sage will result and the terminal will print the contents of the 
fC68010 roisters® Bie D4^ DS^ ate D6 registers contain status bytes fran the 
disk controller® For more information on interpretir^ the contents of ttese 
roisters, see the Winchester Disk Controller User®s Manual® 

Tte other infomation used frai the volime ID is; 


BYTK 

$14-$17 

$18-$19 

$1E-$21 

$90-$93 

$94 


USED FOR 

Starting ¥ERSMos sector tedress of program to te loaded (via 

m) ® 

Mjntoer of VERSMos sectors to te loteed® 

to^d address (first destination rnoiwry byte) ® 

VERSMos sector tedress of mteia configuration ^raieters 
(see Ap^teix C) ® 


terqth of configuration area 


(usually one VERSMos sector) 



1®4 RffER^CE MAMJAI5 

Refer to tte followirg docments for more information on tte envirorinents in 
which TElfcug is uste® 

WE/10 Microcanputer Systai Overview Manual^ f*®8KVS(M 
VME/10 Microcanputer Systan Diagnostics Manual, I^SKVaM 
WE/10 MicrocOTputer Systen Hardware ^nual, P«8KVSfM 
Winchester Disk Controller U»r®s tenual, WSWINI 
fWMI400 Dual RS~232C ferial ^rt Module User's Manual, MWffi400 
MVW410 Dual 16-Bit Parallel Port Ptaiule U»r®s Pfenual, MVME410 
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CHAPTER 2 


TEHbug OPERATII«S PKKEDURE 


2®1 IWrroDlETICM 

Tte followir^ proceSures enable the user to enter TENbug® For information on 
systen irstallation^ self-test diagnostic prograns^ ai«a Oferating systan 
initialization^ refer to the VME/10 MicrocoriEMter Systan Overvia^ ani 
DiagncMtics manuals® 


2b 2 QIASSIS tt)NTROL SWITCHES 


^fore attanptir^ to initiate TlEMbug? the user stould be familiar with the 
o^rator ^nel located at the bottan left corner on the front of the Wffi/10 
chassis® This panel contains the followir^ control switches \flrtiich are supported 
by TEMbug® Use of the^ switches is describe! in paragraphs 2.4 through 2.6. 


a s 


0 


- Tte amber-colored power on/off rocker-arm switch is used to 
turn ^ on power to the Vfffi/10 and initiate the po^r-up/reset self-test 
(PI'^T) . Wten the 0 side is pressed , power is off| when the 1 side is 
pressed y power is on. 


b. KYBD LOCK - The KYBD WCK key switch controls a bit in a register which 
is monitored by TEbtoug. When the key switch is in the locked positiooi. 
VME/10 performs an automatic ^ catmand from device 0 (this usually 
starts the operating system) . When the key switch is in the unlocked 
position, VME/10 enters TE^ug. Also, when tte key switch is in tte 
locke! position, the front panel pushbutton switches RESET and ABORT are 
inoperative. This feature provides protection fron inadvertent panel 
interrupts during system usage. 


c® RESET - When this nrarontary-action pushbutton switch is pressed, it 
r^ets the VME/10 Ic^ic circuits® If the VME/10 is in the operatir^ 
system, TEbtoug is entered by pressing RESET (provided the KXBD LCCK key- 
switch is in the unlocked position) , Because pressir^ RESET can cause 
ir^terminate results, read the warm start description in paragraph 2.6 
before usii^ this switch, 

d. AK»T - When this monentary-action pushbutton switch is press^ (provided 
the KXBD LO^K switch is in the unlocked position) , the VME/10 enters 
Tafcug, but tte VME/10 logic circuits are not reset® After an abort, tte 
u»r can enter ®G' to contini:® execution of the current progran prior to 
tte abort. Ap^redix A describes what occurs when the ABORT switch is 
pressed. 

e. RKET ate AKM* - The^ buttons may he used in canbination to Kircanplish 
tte s«e thing as tte on/off switch (itam a.) without cyclirq p3%«r® 
Hiis simulatai cold-start sequence is described in ^ragraph 2.5. 


23 TEWimL CCMTOOL CHARACTERS 


Several keys are used as COTwerri line edit and control functions^ Hie user 
should be faiiliar with these functions before using TENbi^« Hie functions 
incliMes 

a. DEL key or CTRL H - will delete the last character entered on terminal. 

b. CTRL X ” will cancel the entire line. 

c. CTRL D “ will redisplay the entire line. 

<--l (carriage return) - will enter the conmand line and cause 
processing to begin. 

e. CTRL W - will suspend system output to the terminal. To resune output to 
the terirdnal^ any other character can be entered. 

f. BREAK - will atort conmarcis that do any console I/O and return to the 
input routine. 


For characters requirirg the control key (CTRL) , the CTRL should be pressed and 
held down, and then the other key (H, X, D, or W) should be- pressed. 


2.4 ENTERIC TBibiq DURIK3 SYSTEM PCWER-UP (COLD START) 

Invokirq TMbug usir>g the cold-start technique causes the contents of all memory 
to be destroyed. It also causes the VME/10 system to place the contents of 
addresses F00000-R30003 into the supervisor stack, arri the contents of 
F00004-F00007 into the program counter. Hiese addresses are located in system 
RCM. Figure 2-1 illustrates a flow diagram of the VME/10 cold-start procedure. 


2.4.1 Cold Start without MVME400 »dule 

Hiis ntethod allows the user to enter TENbig during systen ^v«r--up when no 
MVME400 ( RS— 232C Serxal Port) ii^^dule is present in the VME card cage. 


a. Set the KYBD LKK key switch on the curator panel to the unlocked 
^sition. 

b. ^ply to chassis. Mien ^wer is applied, the WRT self-test is 

initiate. 

c. If self"test irdicates no errors, the pranpt and version 

nimter will apj^ar on the screen i 

TEftoiq x.y > 


2«2 









2®4®2 <i)ld Start with WME400 tedule 


Itiis method allow the user to enter Tfflbug durir^ systen |»wer-up ^en an 
^ME400 irodule _is present in the VME card cage* 

a* Set the KYBD LCXZK key switch on the operator ^nel to the unlocked 
it ion* 

b* Apply power to chassis* Wien powr is applied^ the PWRT self-test is 
initiated* 

c* If self-test indicates no errors^ the firmware displays a prompt 

without a version nsjiiber* 

Taibug > 

It then awaits input from the first device to be used^ ^ich will te the 
console terminal* 

d* Select the terminal to serve as the console keyboard* This device will 
remain the console device until the ¥MJE/10 is restarted with a warm- or 
cold“-start procedure* 

e* Press the carriage return key on the chosen keytxjard to obtain the 
ccuplete TQIbi^ proopt with version nmtoer* 

TMh\^ x*y > 


2*5 aiTERItC TENbLQ VIA SIPtJLATED COLD START 

A cold-start sequence (the equivalent of turning the ^wer off and on) can be 
simulates viien the KYBD LCCK switch is set to the unlocked ^^3SXtxon* Use the 
RESET and ATOOT buttons as follows i 

a® Press and hold RESET button® 

b* Press ar^ release ABORT button* 

c® Release RESET button* 

d* ^en an MVME400 n»dule is not present in the VME card cage^ go to step c* 
of ^r^raph 2*4*1* 

e* Mien an WME400 nwdule is present in the VME card cage^ go to step c* of 
^ragraph 2*4*2* ■ 


Like the true cold-start sequence ^ this method will erase all merory contents 
art will execute the MT self-test® ' It will also place the contents of IW 
addresses ro0000-R)0003 into the su^rvisor stacks and the contents of 
F00004“ro0007 into the program counter. In other wrds^ it translates the WM 
at rooooo to location 000000^ so that the R« at location 0 is napped out of the 
systai® 


2.6 aiTERIffi T^ug WITHOIT [KSTROYIbO MmmY COWTENTS (mm START) 

This nettoS allwe tte o^r to enter T^aug wittoot destroy! tte contents of 
the ¥fffi/10 merory. Itowever, usir^ the warm-start segi^ix^ (pressing RESET only) 
causes the ¥ME/10 to place the contents of RM ^dres^s 0-$3 into tte 
supervisor stack*, ate tte contents of $4“$7 into the program counter. It also 
sets tte pro^s^r to supervisor state® 

CAUTICM 

mSMJSE THiSE MOEJESSES M$ UXATW IN 
THE ISER cm (NERLAY ANY DATA (M ADDRESS 
INTO IHESE RH3ISTEIS, IN WHICH CASE RESULTS 
ARE INDETEIMINATE® 

a® tet the KYBD LCCK key switch to tte unlocked position. 
b» Press tte RESET button on tte operator fanel® 

c® Wten an fWME400 module is not present in the W1E card cage^ go to step c® 
of paragraph 2.4.1. 

d. Mien an HyME400 module is present in tte WE card cage^ go to step c. of 
paragraph 2,4.2. 


2.7 TQIbug OOffftND CPERATICM 

After TQtoug initialization, the comgwter waits for a coiroand line input fran 
the console terminal, A standard iqput routine controls tte- system while the 
user types a line of ir^ut. Gonnard processir^ tegins only after the line has 
been entered, followel by a carriage return. Wten a proper coiraand is enterte, 
the operation continues in one of two basic motes. If tte conmand causes 
execution of a user program, tte TEMxig fimware may or may not he reenterte, 
d^endir^ on the discretion of tte user. For tte alternate case, tte camard 
will be executed order control of tte TEIIaug condition. EHirir^ cannard 
execution, additional user input may be r^uir^, tependir^ on tte ccnmard 
function. 

Figure 2-2 illustrates the ¥BE/10 operational irote, 

^K)TE 

If a ccxiraand causes tte systen to access an unused aidress 
(i.e,, no msBory or peripheral tevices are located at that 
aldress) , a bus trap error will occur. Unless default 
vectors have teen overwritten, tte terminal displays a tr^ 
error message ard tte contents of all M368010 roisters. 

Control is tten returnel to tte TQfcug monitor, A bus trap 
error also occurs if tte systCTi attanpts to write to KM, 


2.8 mm TM}ug PMMPT FAIIS TO APPEAR 

Refer to Qi^ter 2 of the ¥^/10 Microccmpiter Systos Di^n<»tics Manual for 
instructiorB if tte PWOT seqi«nc» fails ar^3/or no TErt3i^ ^ai^t ap^ars durir^ 
one of tte prarfures list^ in this chapter. 
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FIGOME 2-2. flow Di^r«i of (^rational mde 
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CHAPTER 3 


CCM1AM) LINE FORMAT 


3.1 INITODUCriW 

Ownarfs are entered in buffer-organizrf fashion. A standard input routine 
controls the systan vAiile the user types a line of input. Processing begins 
only after the carriage return has been entered. 

Many primitive coiwiareSs can be altered, by the options field. This provides the 
user several extensions to the primitive conroands. 

Several comnands are set and reset pairs; i.e.^ rather than having primitive 
commrds^ the fora NO is added as the first tW3 characters of the coimiaiid. Bbr 
example, the set break^int conmand is BR, and the reset breakpoint conmand is 

tomiar^ line formats are presented in a modified Backus-Naur Form (BNF) . 
Certain spitols in the syntax may be used, ^ere noted, in the real I/O® Others 
are ineta-spibols, ^ich are used for definition only and are not entered by the 
user® Hiese meta-symtols and their meanings are as follows i 

< > Angular brackets enclose a known as a syntactic variable, 

that is replaced in a coiwnard line by one of a class of spitols it 

represents « 

! Hiis symtol indicates that a choice is to te made, ttie of several 

symbols, separated by this symbol, should be selected, 

[ ] Square brackets enclose a spibol that is optional, Hie enclosed 

spitol may occur zero or one time, 

[ I®,, Square brackets followed by periods enclose a symbol that is 

optional/re^titive, Hie symbol may ap^ar zero or rt»re tiroes. 


In the examples given in the followir^ paragra^s, curator entries are shown 
urrierscored for clarity only — » the underscore is r»t to te ty{»d, 

Orator entries are followd by a carriage return unless otherwise specified, 
Ihe carri^e return is not stown in examples except where it is the only entry, 
in "Aich case it is show as (CR) , 
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3.2 TENbug C»mND LINE FORMAT 

Itie forpat of the TMbiq conwerd line iss 

TENbi^ x.y > [NO] <caTW 0 rrf> [<^rt number] [<paranieters>] [|<options>] 


where s 


TENBUG x.y > 

Is the tosic TENbi^ pranpt. For prompt 

appropriate command descriptions. 

variations, see 

NO 

Is the negative form (opposite) of primitive coitmand. 

coitmand 

Is the primitive comnand. 


pDTt niMber 

Specifies the applicable device port. 


parameters 

Can he of the form <expression> or <address> 
separated by spaces. 

and are usually 

options 

Multiple options may be selected. 



The basic coimand form consists of the primitive cortmand field and the 
parameters field, althoiqh some primitives do not require parameters. Soiw 
primitive cominands allow specification of alternate device ports. 'flie 
additional coinmarKi negation ard options field can modify the primitive coitinarii. 

If an option exists for a command, a semicolon (i) plus <options> field (s) are 
added to the conmand. Ihus, several extensions can be provided to the user. 


3.2.1 depression as a parameter 

An <expression> can be one or more nuneric values separated by the arittaetic 
operators plus (+) or minus (-) . Numbers are assumed hexadecimal except for 
ttose preceded by an ampersand (&) , which are decimal. In the assaitoler, 
nunbers are assuned decimal unless preceded by a dollar sign ($) . 


3.2.2 Mdress as a parameter 

Many cotmards use <address> as a parameter. Hie syntax accepts by is 
the same as that accepted by the assentoler, plus a memory indirect node. Mso, 
contained within TENbug are eight offset registers designate R0-R7. Hiese 
registers are software registers only, and are provided for easier debiJ^ging of 
relocatable code. 
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3®2®2.1 Mdress formats 


fwmT 

KMPLE 

DESCRIOTCW 

expression 

140 

Asolute address (NOTEs offset zero is added)® 

expression+offset 

130+R5 

Ateolute address plus offset five (not an 
assaitoler-acceptrf syntax) ® 

expression+offset 

150+R7 

Ateolute address (NOTEi offset seven is always 
zeroi not an assentoler-acceptrf s^Titax) ® 

m) 

(A5) 

Mdress register indirect. 


(<^6 ^D4} 

address register irriirect with irdex® 

express ion (-^) 

120(A3) 

Roister irdirect with displacement. 

express ion ( f M ) 
expression W ) 

110(A2rDl) 

Mdress register indirect with index plus dis- 
placeiient . 

[expression] 

[100] 

syntax) ® * 


3®2«2®2 Offset Registers . Eight software registers (not actually hardware 
configured) are used to nwdify addresses contained in TMbi^ comMrris. Hie 
first seven registers («R0-®R6) are used as general“pur|»se offsets^ ®R7 

(the eighth register) is always zero« Ihe contents of the registers can te 
displayed by the offset coimiarrf (OF) ^ paragraph 4^2Alf and nwdified by the 
Xregister> camiar^^ ^ragraph 

Itie offset registers are always reset to zero at ^wer-up^ Hiusi if their 
contents are not changed j, the registers will have no effect on the entered 
^dress ® 


Unless another offset is entered r each ccmnand that exacts an address parameter 

automatically adds offset RO to the entered address — that is^ if RO * 1000 ^ 
then the foTTowi^ comnarris are the sai«s 



10 

(10 + 1000) 


is added by default 

BR 

lO+RO 

(10 + 1000) 



BR 

1010+R7 

(1010 + 0) 

R7 

is always zero 


ttie physical address for each of these coniards is 1010® 

Offset TO is automatically added to the offset registers any time they are 
wdified® Hie only exception to this is #ien another offset register is 
s^cifically ^ded® Offset registers lay te set to zero by addirq R7 (always 
zero) to zero® 


KMPLEi 


RO 

0+R7 

(RO * 0 + 0 

« 0) 

RO set 

to 

zero 

.R1 

8 

(R1 * 8 + 0 

* 8) 

Offset 

m 

is zero^ ! 

,ro 

100 

o 

1! 

O 

O 

+ 

0 * 100) 

Offset 

RO 

added 

,R0 

200 

(TO * 200 

100 « 300) 

Offset 

m 

added 

R3 

100+Rl 

(R3 * 100 + 

8 * 108) 

Offset 

m 

not added 

m 

0+R7 

(TO * 0 + 0 

* 0) 

ro set 

to 

zero 


R1 is set to 8 
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33 caf«® VERIFICATIOJ 


As an aid to the user^ TENbi^ displays for irost coiwnands its 
the values entered as expression and address parameters® 
displayed in either physical or logical format^ dependir^ 
entered® 


interpretation of 
The results are 
ii|»n the coimiand 


EXMPLES : 

Taibug x®y > ®R0 1000 
TMbsjg x®y > ®PC 0 


Ii3g i cal Format Ex®iple 
TENbi^ x®y > MD 0 

000000+ro 4E 71 4E 71 4E 71 4E 71 4E 71 00 00 OF 90 00 00 NqNqNcp^q® ® ® ® ® o 


fttysical Format Example 

TEMDug x®y > GT 8 
PHYSICAL ADroESS=00001008 
PHYSICAL M)DRESS=00001000 


AT BREAKPOINT 

P000001008 SI^2700='.S7®®®®® USP*00012C5C SSP=0000085E VBI^OOOOOOOO 
D0“7 00304E71 00001000 4E711000 00000000 00004E7i 0000002C 00001008 
A0~7 0000041m 00000000 00001000 0000053A 00001002 00000551 00000551 
PO000008+R0 4E71 NOP 


SF^l DP^O 
00000000 
0000085E 


Cc«mards entered are also checked for validity® For example^ specifyirq an 
address parameter ^lich would result in an error may cause the message INVALID 


ADE®ESS=xxxxxxxx to te displayed on the console terminal 
error messages is provided in Appendix B® 
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CHAPTER 4 


C»«ND SET 


4.1 IMFROUCTI® 

Oiapter 4 describes the coranand line syntax and provides one or more examples 
for each cofmai^ in the T®bi^ caffiiarrf set. Table 4-1 lists Tfflbug. camarKi 
imeironics by type. 

TABLE 4-1. TE^i^ ^Miands by Ty^ 



.A0-.A7 Display/set address register 

.D0~.D7 Display/set data register 

®DFC Display/set destination function code 

.PC Display/set pr^ran counter 

.SPC Display/set source function code 

.SR Display/set status register 

.SSP Display/set supervisor stack pointer 

.USP Display/set user stack winter 

.¥BR Display/set vector base register 

DF Display fornetted registers 


.ro-.R6 Display/set relative offset register 

OF Display offsets 


BR Breaks int set 

^BR tenove breaks int 

GO &ecute prog ran 

GT to mtil break^int 

GD Go direct execute program 

TO Trace 

Tf Trace to tan^rary breaks int 


PA Printer attach 

IWA tetach printer 


ffl ftsotstrap halt 

BO tootstrap operating systai 




4.2 C^»Nre 

A caiplete description of each TQIbug coiinard is provided in the 
^ragraphs. ftessages resultir^ from error conditions during comnand 
are described in Ap^rrfix B. 


followir^ 

execution 
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4® 2.1 Display/Set teg is ter 


*<r^ister> 


.<register> [<expression>] 

ttie Xregister> coiwBrds allow the user to display or nodify ii^ividual 
registers, tonumnds with a leadir^ period and the roisters displayrt/altered 
by these c«inarris are; 

.M-.A7 address register 

.ro-.D7 data register 

.orc destination fmction code (used with ^68010 ^WES instruction) 

.PC progran counter 

.R0-.R6 relative offset register (software register) 

(refer to OF comiand) 

.src source function code (used with MC68010 WVES instruction) 

.SR status register (in the MC68010) 

.SSP su^rvisor stack pointer 

.USP user stack winter 

,VBR vector base register 


cmmrr 

TKbt^ x.y > Display program counter. 

.P^OOOOIOIO 

x.y > .A7 1300 Set address register seven. 

x.y > .R5 5500 Set relative offset register five. 

Tabtg x.y > DF 

P^OOOOIOIO 8^2700*. US^0000C19E SS^00001300 VBR«00000000 SP02 DR>2 


E»*-7 00000000 00000000 00003048 4D453455 00000000 00000020 00000000 0007FFPE 
M-7 OOPICODI 00001694 0000065C 00TO1D72 00FO120C 00000538 000005» 00001300 
P^OOIOIO 
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4®2®2 tootstrap Halt (BH) 


BH [<device>] [^<controller>] 


^erei 

device Is a single hexadecinal digit (0-^3) specifying the device to 

te used (default ® 0) ® 

controller Is a sir^le hexadecimal digit (0) s^cifyir^ the controller 
to ^ich the device is connected (default * 0) ® 


Bie BH caaMfrf causes data from disk to te loaded into i«»ry and prc^ran 
control to be given to TQibi^.. If device arrf/or controller are not s|»cified, 
device 0 ar^ controller 0 are used® 

Biis caiward wrks the sane as BO# except that control is transferred to 


See also: BO 


- Boot Halt from default drive 0, default controller 0® 
x.y > ffl 

P0«00001694 S^2700»®S7®®®®® USE^0000C19E SS^00040EOO VB^OOOOOOOO SF^2 Di^2 
m-7 00000000 00000000 00003048 4D453455 00000000 00000020 00000000 0007FPPE 
AO-7 OOFICODI 00001694 0000065C 00F01D72 00F0120C 00000538 00000538 00040E00 
rc=0G1694 


Ncyrs 

'to use the Bi coinard^ a valid stack value must te in 
locations $0-*$3 of the file teir^ loaded® If the stack 
value is 0# the results are ir^eterminate® 



4®2®3 Bootstrap C^ratir^ Syst« (BO) 


BO 


BO [<device>] [^<controlier>] [^<string>] 

^erei 

device 


controller 


Is a single hexadecimal digit (0-3) specifying the device to 
te used (default - 0) e 

Is a single hexadecimal digit (0) s|»cxfyiirq the controller 
to %Aiich the device is connected (default = 0) . 

Is an optional ASCII character string that is passed to the 
program being loaded from the specified device and 
controller, 

■Rie function of the BO coranand is to access a program on disk^ transfer it into 
meifory space ^ and give control to that program, y^ere to find the program 
i«^ere in memory to store the program is contained in sector 0 of the disk 
corresporrfir^ to the specified device and controller. If the device and 

controller are not specified^ the default value zero is used for each, 

Ihe following sequence occurs v\^en the BO command is executed j 

a® Starting at sector 0 (the volume ID) f 256 bytes are read and transferred 
into TENbug workspace RAM, 

b. Volume ID locations $lf8“$FP are read to ensure that they contain the 
string ''EXCKMACS”, 

c. Ihe location of the program to- be loaded and its destination in momory 
are identified by examining volume ID locations as siiowns 

LOCATIONS CCOTB4TS 

$14-$ 17 First VERSAdos sector to transfer 

$18-$19 Number of VERSAdos sectors to transfer 

$1E“$21 Mdress of first destination byte (first HBirory address) 

d. The location of the disk configuration area is identified by exaninir^ 
volime ID locations as shown; 

L^Ti«s carrwrs 

$90“$93 VERSAdos sector address of the media configuration 

parameters (normally VERSAdos sector 1) 

$94 Ler^th of the configuration area (nomially one VEKMos 

sector) 


If there is no media configuration area specified^ default ledia 
configuration values are used to read the disk. If there is a n»dia 
configuration area specified i then that VE^Mos sector is read into the 
wrkspace^ arri these values are us^ to re^ the disk. See 
^»rdix C for ^ditlonal information. 
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e. The program is read and transferred to its raeiDry destination. 

f. Hie status register is up3at^ to reflect su|»rvisor iiwde and interrupt 
level seven. 

g® Hie stack |»inter is loaded from locations $0”$3 relative to the 
destination meiory. 

h® Hie prograi counter is loaded from locations $4”$7 relative to the 
destination meiory. 

Hie registers are set up as defined below^ and the program loaded by the BO 
cawerd now has control of execution. 


TO... DRIVE MJMBER 

D1...IPC NUWER 

D2...DISK CMFIGURATIOT C®E 

D3...FLM3 Fm IPL; ®ME4U® = USE BI,KS’ DISK READ ROUTINE 

M... ADDRESS OF DISK CWTROLLER B^RD 

M . . .ATOESS OF PRffiRM JUST LWOED 

A2...ffiORESS OF DISK CWFIGIIRATI« DATA 

A3..®AraiESS OF BIKS' DISK READ ROUTINE 

A4... ADDRESS OF HiE DEBKGER EMTRY POINT ("MACSBIK") 

A5... START OF TEXT 

A6...END OF TEXT+1 (WHERE THE NEXT CHARACTER WOULD GO) 

A7... STACK OF PROTRAM JUST LOADED 
SR. ..SUPERVISOR WDE AND LEVEL SWM 

Hiese registers can be used by IPL to load in the file identified by the string 
field. If a strir^ field is s^cified on the BO command line^ registers A5 and 
A6 point to the first and last plus one characters of the string. If no string 
is s'^cified# register A5 * Ihe file name may te follow^ by a sanicolon 

arrf either or toth of the options l>$<address> or H. S^cifying H causes 
tc^ r 't isi t*^! program. 

Refer to the discussion of the bootload file, IPL.SY, in the *8000 Family 
VSRS^^los Systeni Facxlxties Reference ^^anual , ^^^58KVSF® 

•fce devices arri controllers currently sup^rted by TMbi^ are assigned as 
follows 


DESCRIPTim 

Winchester Bard Disk 
Winchester IMrd Disk 
5 1/4" Winchester Flopw Disk 
5 1/4" Winchester FlopR^ 


CWTTOLLER # 


DESCRIPTIM 


IMINl Disk Controller 
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KMPLES 

x^y 

TMbi^ x^y 


BO 


CQWEgfTS 

> TO &>ot from the first hard disk (default device 0) on 

the (default controller 0) ® 

> BO 1 Boot from the secorri hard disk (device 1) on the 

raCENl (default controller 0) » 
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4^2 A Breakpoint Set arri R&mve (BR ai^ NOBR) 


NOBR 


BR (display only) 

m [<address> [ i<count>] ] [<address> [ ;<count>] ] ® ® 
NOBR [<address> [<address>] . ® « ] 


Mien encountered^ a break^int causes target program execution to stop and 
control to te transferred to TENbug® The BR coniiiand may be used without 
paraiteters to cause display of current break^int addresses® Bie BR <address> 
coiKiand sets one or ii»re addresses into the breakpoint address table® Hiis 
table can hold up to eight break^int addresses® Multiple breakpDints (up to 
eight) may be specified with one call of the breakpoint conmand® Mdresses 
stould be on even mrd fcxjundaries® Hie range of <count> is a 32-bit int^er® 

The break^ints are inserted into the target prc^ram when execution is called 
via a GO or GT conmand® The illegal instruction $4A£B is inserted at the 
addresses s^cified by the table® Raring execution of the prograur a break^int 
occurs #ienever this instruction is encountered® If program control is lost^ 
control may te regained via the RESET or the ABORT button® AMOT is preferred 
tecause use of the RESET function may leave break|»ints ($4AfB) in ttie user 
pr(^ram^ whereas ABCKT will recover properly (see Apperrfix A) ® 

While executing a Trace COTWiard^ the break^int addresses are nwnitored 
the illegal instruction $4AFB is not placed in meirory) ® 

After stopping at a breakpoint ^ execution may te continued by typing the GO 
comnarri® 


The NOBR ccximarrf raroves one or n»re break|»ints from the internal break^int 
table® Hie NOBR conmemi without ^rameters eliminates all break^ints® 


BR CW«® FCKMAT DESCRIFTIOT 


x.y > BR 

TENbi^ x®y > BR <address> 

TENbi^ x®y > BR <address>i<count> 


Display all break^ints® 

Set a break|»int® 

Set a break^int with a count® Count is 
decremented each time tlie break^int is 
encountered until <count> * 0® Execution 
stops as soon as count is decremented to 
zero® Thereafter j execution will stop 
each time the breakfwint is reached® 


MBR C Wmtl) FCMAT 
TMbi:q x®y > NCBR 
TiMbug x®y > tTOR <a^ress> 


DESCRIPTICM 

Clear all break^ints® 

Clear a specific break^int® 


also I GTr TT 


m 

now 


awLE 

Tato^ x.y > M 4000 

x.y > BE 1010 2000 1 5 2040 4000 

BREAKPOINTS 
001010 001010 

002000 0020001 5 

002040 002040 

000000+R4 004000 

TBtoyg x.y > 1010 2040 

BREAKPOINTS 
002000 002000; 5 

OOOOO0+R4 004000 

TiMaug x*y > NMR 

BREAKPOINTS 

Tatoug x*y > 
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4.2,5 Display Foraatted Registers (DF) 


DF 


DF 



Ttie DF coiiiiari3 is used to display the *68010 registers « The registers display 
is also provided whenever TMbcq gains control of the program execution — i,e,, 
at breakpoints and tracir^. 

Note that any sir^le register can be displayed with the ^A0-aA7^ cro-®D7|. etc®^ 
coiroands® See the display/set register conmarri (Xregister>) ^ and the OF 
coimiand® 


EXMPLE 

TEBtoug x.y > DF 

PO00F02C9E SR=2704=®S7®®Z® ® USP=FFFFFFFF SSP=000007C4 VBR=00000000 SFC=2 DFC=2 
EXI-7 00300030 00000804 00000000 00000000 4D505520 00000020 00000000 00000000 
AO-7 00F1A031 00R)133C 00F008AA 00000458 0000049A 00000536 00000536 000007C4 
PC=F02C9E 


TOtoug x®y > ®R1 3000 
TEltoug x®y > ®PC 40000 
Tatoig x®y > ®SS COO 
TEItoi^ x.y > DF 

P000040000 S^2704=®S7.®Z.. USP=FFFFFFFF SSE^OOOOOCOO VBft=00000000 
ro-7 00300030 00000804 00000000 00000000 4D505520 00000020 00000000 
m-7 00F1AO31 00F0133C 00F008AA 00000458 0000049A 00000536 00000536 
PC>03I»00+R1 

TEtoig x.y > 



SFC=2 DFC=2 
00000000 
ooooocoo 
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4.2.6 Bcecute Pr^ran (G) 


G 


G[0| [<address>] 


ttie G (or GO} c«iaiM causes the target program to execute (free run in real 
tiM) until! 

a. Bie target program encounters a breaks int^ 

b. to atawmal prograi sequence causes exception processir^ (e.g.^ divide by 
zero) r or 

c® ®ie operator intervenes throi^h use of the RESET or ATOOT pushbuttons on 
the ¥1^10 oi^rator {»nel® 


MOTS 

Bie execution will not te in real tine if 
break^ints with <coiJtit> are encountered® 


•ttie G seqiKnce starts by tracir^ one instruction ^ settir^ any break^ints^ and 
then free running® 

C^AND FCMAT DESCRIPTICM 

Tat>i:g x.y > G Begin execution at address in EC® 

TQfcug x.y > GO <address> Set PC = address and teg in execution at 

that ^dress® 

See also! DF^ GD^ GT^ TR^ TT 

EXMiPLE 

(Listir^ of progran in maiory at location 000900} 


000900 

1018 

MWE.B 

CA0) + ,D 

000902 

ocoooooo 


#o,ro 

000906 

67F8 


$000900 

000908 

4E75 




TMbi^ x.y > BR 900 908 


mEMTOIlWS 
000900 000900 

00(B08 000908 

Tfflbi^ x.y > G 900 
PIffSIttL »3raSS=00000900 

AT BRE»P0I1T 

PC^00000908 USP=0000C19E SS^OOOOOCOO VBR=00000000 SF02 DPG=2 

01-7 00000020 00000000 00003048 4D453455 00000000 00000020 00000000 0007FFFE 
m-7 0000160D 00001694 0000065C 00roiD72 00501200 00000538 00000538 OOOOOCOO 
^000908 

TBlJiq x.y > 
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4«2.7 Q} Direct Execute Pr<^rai (GD) 


GD 


GD [<address>] 


•fte GD comiarel is similar to the GO coimieraar except that GD does not set 
break|»ints^ nor does it start by tracing one instruction® Bie GD romnand 
starts the target prograi at the location given as address without char^ir^ any 
of the exception vectors (default locations 0 through $3FF) ® If <address> is 
not s|»cifi«3f the GD cacHBrri starts the target prcgran at the address in the 
program counter® 


See alsos GOf GT 


EXAMPLE 

at location 000900) 
W¥E®B (A0)+^I» 
C»®B #0,0) 

ME®S $000900 

RTS 

TENbug x^y > B R 900 908 

BREAKPOINTS 
000900 0009Q0 

000908 000908 

TENbug x»y > G 900 
PHYSICAL AI1»ESS=00000900 


(Listing of program in meRory 
000900 1018 

000902 OCOOOOOO 

000906 66F8 

000908 4E75 


AT BREAKPOINT 

P0=00000900 SI^2704=®S7®®Z®® US^0000C19E SSE^OOOOOCOO VB^OOOOOOOO SF02 DFC=2 
m~7 00000000 00000000 00003048 4D453455 00000000 00000020 00000000 0007FFFE 
AO-7 00001002 00001694 000006 5C 00roiD72 00roi20C 00000538 00000538 OOOOOCOO 
PC=000900 

TENbi^ x®y > GD 900 
PHYSICAL AE»RESS=00000900 
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03 Until Breaks int (GT) 


/^rp 


GT <teiip3rary breakpoint address> 

fte GT cawfBnd perfonis the followings 

a. Sets the taii|x>rary breakpoint specified on the conroand line* 

b* Sets break^ints entered by the BR ccranand. 

c* Sets target program registers as displayed by the DF comarid® 

d* Causes the target program to execute from the PC aldress (free run in 
real time) * 

Wien any breakpoint is encountered, the temporary breakpoint is reset* 

See also; BR, DF, GD, GO, TR, TT 


EXAMPLE 

(Listing of program in memory at location 000900) 


000900 

1018 

MjyE.B 

(A0) + ,IX 

000902 

OCOOOOOO 

CMP.B 

#0,D0 

000906 

66F8 

BNE.S 

$000900 

000908 

4E75 

RTS 


TEMdlq 

x.y > BR 900 908 




BREAKPOINTS 
000900 000900 

000908 000908 


TEMDug x,y > .PC 900 

TEM^ug x.y > GT 906 
PHYSICAL AI1»ESS=00000906 
PHYSICAL ADDRESS=00000900 

AT BREAKPOINT 

B>00000906 SR=2700=.S7 USP=0000C19E SSP=00000BF8 VBR=00000000 SF02 Drc=2 

m-1 00000020 00000000 00003048 4D453455 00000000 00000020 00000000 0007FFFE 
m-1 0000160E 00001694 0000065C 00F0iD72 00F0120C 000005^ 00000538 OOOOOBEB 
^000906 

TEItx^ x.y > BR 

BRmKPOBTTS 
000900 000900 

000908 000908 

x.y > 
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4®2.9 Iteiory fttify (M) 


M 


M [M] <^dress> [ ; <opt ions> ] 

Tfie function of tte M or ^ c«inand is to diar^e data in maiory® An ^dr®s arrf 
options ar© s^©cifis3 on ti® initial coninarKi lin©® 

For convenient viewing ard changing of object data^. four variations of data 
up3atif^ caiability are offerrf* These are enhanced by five options i tte data 
size options g word ard long word (the default size is byte) | «dd or even ^dress 
access optioFK (byte-size only) | and a nonverification option for write-only 
o|»rations® Action provided by an option sf^cifi^ on the initial ccmnard line 
is utilizrf in all four data updating subnodes and remains in force until tte M 
cannard is exited® 

Bie five iMTOry change mode options ares 

|W fet size to viord (i*e., two bytes) * 

|L Set size to long wizd (i.e*, four bytes)® 

|0 Set size to bytei access only odd addresses® 

|V Set size to byte? access only even addresses® 

|N Ifo verification® EX) not read data after updating. 


Wien tte merory change mode is entered on execution of the initial commarri linej- 
object data in tte specified locations is displayed in hexadecimal format ard 
tte M camnard prompt (?) , is presented at the right of the data. The data can 
tten be charged, using any of the subcoronands ctescribed below® If desired ^ tte 
aciiion of the subconsBand can be obtained without entering new data. For 
exm^leg the contents of the preceding location(s) can be viewed by typing 
"'^(CR)®® alone after the ? prompt , or tte M corauard can be exitad by typing 
®'®(CR) 


[<data>] (CR) 
[<data>] ''(CR) 
[<(tota>] = (CR) 
[<data>] ® (CR) 


l^ate location and sequence forward, 
l^xdate location and sequer^^ teckward® 
l^ate location and reopen sane location® 
l^date location ard terminate. 


fee alsoi f® 


Tm^m x.y > M 1000 ;L 
00001000 00000000 ? 200 = 
00001000 00000200 ? ^ 

TWmxs x.y > f*l 40000 ;W|N 
00040000 ? ^ 

00040002 ? 34® 


4. 2® 10 ^M»ry Display (F©) 


W 

ms 


»[<^rt nii*er>| <address> [<coimt>] 
<a3dress> [<OTijnt>| 


!® c<Mi!Bi^ displays a portion of imiory ^ich tegins at <address> ami 
extei^s for tte Dtt*er of bytes given as <couiit>® If <count> is not s^ifirf^ 
tte ^fault is $10 byt« or^ if f€B is tte stefault niMter of bytes is $100 

(a »ction) « display is in hex ate in ASCII characters® 

tefault output is to tte console terminal. S^cifyirg M3<E»rt nuii[iter> allows 
ojtput to te sent to anotter port. 

Valid port rasters for this camate arei 

noi» tefaults to T^ug ^rt 1 (VME/10 built-in terminalAeytoard) 

1 s^cifi^ T^ug pjrt 1 (VME/10 built-in terminalAeyteard) 

2 ' s^cifies T^ug port 2 CWME400 port 1 - 7201/A) 

3 s^cifies Tatoug port 3 CMVME400 port 2 - 7201/B) 

4 s^ifies ^rt 4 CMVME410 port 1 - PIVA) 

5 specifies T^ug pjrt 5 Cf«E410 port 2 - PIA/B) 


After tte MD camete is enterte^ it will continue with the next 16 lines of 
outpit e^h tine a carri^e return (CR) is enterte® Any otter camate exits f® 
ate enters tte r»w ccmiete® 


See also I 
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TEltoi:^ x®y > 





4®2®11 Display Off»ts (W) 


CF 


OF 


OF camfBnd displays tte offsets use3 to assist with relocatability arri 
i tiori“irrie^er^fent c^^e® 

Linked scents of code will eaA have a different load ^dress or offset® For 
u*r conveniei^e, seven general purpose off^ts (®R0 - ®R6| are provid«3® 
Offset ®R7 is always zerOj, rfiidi provides a convenient techniqi« for entering an 
Mdr«s wittout an off»t® If no valie is assignal to one of the general 
pur^* off»ts^ it will have the default valiK of zero® 

Onless anotter offset is enters ^ each cawnarri that ex|»cts an address paraneter 
automatically adds off^t M to the enteral aldress — that is^ if RO = 1000^ 
tte follwir^ camarris are tte sanei 

BR 10 (10 + 1000) Offset RO aldrf by default® 

BR lO+RO (10 + 1000) 

BR 1010+R7 (1010 +0) R7 is always zero® 

Tim physical ^dress for each of ttese comerds is 1010® 


EXAMPLE 

Tatoug x®y > .R1 1000 
THtoug x®y > ®R3 33000 
T^&ug x®y > ,R4 440000 

TBtoug x®y > .R5 0 
TH&ug x®y > ®R6 -1 
Tl^ug x®y > W 

R0=00000000 Rl=00001000 R2=00000000 R3=00033000 
r4=00440000 15=00000000 R6=FFFFFFFF R7=00000000 

Tl^ug x®y > ®R0 1200 


CWIENT 

^^t offset Rl® 


Iteset offset R5® 


Display offsets® 


&t offset RO® 


T^>ug x®y > ^ 10 

000010-i-ro 61 ?_^ Off^t RO is to tte aldress® 

TElfcra x®y > »! 10+17 R7 is always 0^ so it overrides RO® 

000010 00 ?« 


x®y > 


Ito set RO to 0 after it has bem »t to a 
noi>-zero val«j, use tte ccmaard 0+E7"® 
Ite OTiifBnd ®*®R0 0" will r»t alter TO® 
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4.2.12 Printer Attach ar^ Detach (PA arri NOPA) PA 

NOPA 

PA[<port nijiter>J 

mxh 

The PA camerri allows the user to attach the line printer so that infonration 
sent to tiie console terminal will also be printed® (The printer is connected to 
a port on a dual 16”bit parallel port Module# MVME410^ attached to a printer 
toard ^ich canminicates with the VME/10 systen via the I/G Channel® Refer to 
tte initial setup instructions in the WIE/10 Microccxiputer Systan Diagnostics 
Manual®) Ihe board has two PIA's® TENbug takes the la«rer addressed PIA as port 
4 arri the higher as port 5® Default is always port 4® 

Valid port nuntoers for this camend are; 

none defaults to TEMDug port 4 (MVME410 port 1 - PIVA) 

4 si^cifies TENbug port 4 (MVME410 port 1 - PIA/A) 

5 specifies TEJfcug port 5 (MVME410 port 2 -» PIA/B) 

The printer can also be called by the Memory Display CMD4 or MD5) comend® 

If the printer is deselected or not ready, the message PRINTER NOT READY will be 
sent to the console terminal. TENbug will wait until the printer is ready or 
the BREAK key is pushed. 


NOTES 

1. Execution of this catmand when no dual 16-bit parallel port 
module is connected to the I/O Channel may require pressing 
the EiESET pushbutton in order to return control to TENfcwg. 

2. Only one printer port can be attached at a time. 


The NOPA ccanand allws the user to detach the line printer at port 4 or port 5 
from the console terminal. Output will then be displayed on the console 
terminal onlyi it will not be printed. 


EXMPLE CCfflEOT 

TMug x.y > PAS 
TEJtojg x.y > MD 800 90 

000800 FF FF 24 18 FF 7F OC 00 FF 7F 30 04 FF FF 00 00 .0..... 

000810 FF 31 FF FF FF 01 FF FF EF 26 FF FF 7F 22 FF FE .1. 

® Output is displayed on console terminal aM printed 

® at port 5. 


TBfajg x.y > mm 
x.y > 


Future output will be displayai on cor^ole terminal 
only. 


also: » 


4®2®13 Trace (T) 


T 


T[R] [<count>] 


•flie T (or TR| comiarri executes instructions^ one at a time^ tegirmir^ at the 
location minted to by the program counter. After execution of each 
instriKtionr the ^68010 registers are displayed, 

Wien the trace node is entered ^ the pranpt includes a colon (i,e,r 
TQt)i^ x,y i>) , Itiile in this node, typing the single character (CR) will cause 
one instruction to te traced. 

Breakpoints ar^ breakp3int counts are in effect durir^ trace. 

Trace canrot be used to step through interrupts or exceptions (TRAP^ etc,) , 


CMWD 

XeY > T 

x,y s> TR <count> 
TEMii^ x,y i> ( CR) 

TENbug x,y i> 


DESCRIPTION 

Trace one instruction. 

Trace <coijnt> instructions. 

Carriage return (CR) executes next instruction. 

Typing a period (,) follo^d by a (CR) exits trace 

iiKDde, 


NOTE 

If the program counter contains an address that falls tetween 
the startir^ and ereiing addresses of the TQ^bug progran^ a 
warnir^ message^ within DEBUGGER” , will be returned, 
Processir^ will continue but with unexpect^ results if stack 
^inters ar^/or registers are not handled properly. 


See also I DF, GO, GT, TT 
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T 


EXMPLES 


TMDug x.y > >PC 2000 


TEt&iq x.y > TO 
PHYSICAL AroRES^00002000 

PG=00002002 S^2700=.S7»«».. USP=FFFFFFFF SSP=00000800 ¥6^00000000 SFG=2 DF02 
m-7 00304E71 00002000 OT5E2000 00000000 1796AF30 00000020 00000000 00000000 
AO-7 00Et)21cm 00000000 00002000 00000458 00000410 00000551 00000551 00000800 
PC=002002 


X.y i> T 2 

PHYSICAL MX)eES^00002002 

PC=00002004 SI^2700=.S7. ... . OS^FFFFFFFF SS^OOOOOSOO ¥BR=00000000 
m-7 00304E71 00002000 C05E2000 00000000 1796AF30 00000020 00000000 

m-7 00R)21CA 00000000 00002000 00000458 00000410 00000551 00000551 

K:=002004 

PC=00002006 S^2700=.S7..... USE^FFFFFFFF SSP=00000800 ¥BR=00000000 
03-7 00304E71 00002000 C05E2000 00000000 1796AF30 00000020 00000000 

M)-7 00F021CA 00000000 00002000 00000458 00000410 00000551 00000551 

PC=002006 


src=2 Drc=2 
00000000 
00000800 

SK>2 DE€=2 

OOOCOOOO 

00000800 


x.y t> 
x.y > 




4 *2® 14 Trace to teiforary Break|»int {TT) 


TT <break{»iiit address> 

“Bie IT COTBiarxi ^rforms the followings 

Sets a teupsrary breakpoint at the address S|»cified« 

2, Starts pr^raii execution in the trace Mjde® 

3» Traces until any breakpDint with a zero count is encountered » 
4® Resets the teaporary breakpoint* 

The temporary breakpoint is not displayed by the BR coimriand* 

See also; DF^ GO? GT? TR 


EXMPLE 

TEMoug x,y > .PC 2000 


TlEMoug x.y > TT 2006 
PHYSICAL ADKiESS=00002006 
PHYSICAL ADDRESS=00002000 

PC=00002002 SR=2700=.S7..... USP=FFFFFFFF SSP=00000800 VBR=00000000 
DO-7 00304E71 00002000 C05E2000 00000000 1796AF30 00000020 00000000 

AO-7 00F021CA 00000000 00002000 00000458 00000410 00000551 00000551 

PC=002002 

PC=00002004 SR=2700=.S7 USP=FFFFFFFF SSE^OOOOOSOO VBR=00000000 

DO-7 00304E71 00002000 C05E2000 00000000 1796AF30 00000020 00000000 

AO-7 00F021CA 00000000 00002000 00000458 00000410 00000551 00000551 

PC=002004 


SFC=2 DFC=2 
00000000 
00000800 

SFC=2 DF02 

00000000 

00000800 


AT BREAKPOINT 

PC=00002006 SR=2700=.S7 USE^FFFFFFFF SSP=00000800 VBR=00000000 Src=2 DFC=2 

DO-7 00304E71 00002000 C05E2000 00000000 1796AF30 00000020 00000000 00000000 
AO-7 00F021CA 00000000 00002000 00000458 00000410 00000551 00000551 00000800 
K>002006 

x.y ;> 

TQtoi:^ x.y > 
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4.2.15 Video ftep (VM) 


VM 




•Rie ¥M ccwHiarrf toggles the high resolution bit (bit 4 of control register 1) # 
caiBir^ VME/10 RM to be renap^d. “Hiis enables use of toth normal (800 x 
300-pixel matrix) ai^ high (800 x 600~pixel latrix) resolution graphics display 
node. 


Wai THE VM CC»^® IS USED^ ALL VM^IO 
RAM IS REARRJM3ED M® MUST BE RELOADS). 


Hie user enters TENbi^ in the high resolution mode (bit set to 1) ^ with Kenory 
mapped accordingly. Tfie basic TENbog prompt appears s 

TENbi^ x.y > 

When the VM coiKand is entered (bit changed to 0 ) , the monory map is reorganized 
for normal resolution node and a iiodified prcmpt appears ^ich signifies that 
normal imde is in effects 

TEMDug x.y iii> 

Hov^verjr the actual display letrix does not change. By remapping VME/10 meaforyj, 
RAM space is provided for the user to nodify the display by reprc^rajuiiing the 
CRT controller device (m: 6845) that defines the video screen. 

Entering the VM comnand again will remap RAM for high resolution ii»de. 

Descriptions aril nteiwry maps for both retrial and high resolution nodes ap^ar in 
the VIW'IO Microcomputer Systan CK/erview Manual. 

EX^LE 

T^toug x.y > W 
TEM>i^ x.y m> MU 
TE»i^ x.y > 
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MOTES: 


CD See description of .<register> conm^rri, 

(2) Wim CTRL W is usedi the output display can be continued by enterir^ 
any character » 



CHAPTER 5 


Tmlm ROJTINES AVAILABLE TO TOE USER 


5.1 IMiraUCTIOl 

TOis chapter descrites the TMbijq TW |15 I/O handler, ^ich allows syst«i 
calls from user programs. TOe systOT calls can be used to access selected 
functional routines contained within th© TQIbi^ firinwarei includir^ input and 
outpjt routines. TOAP #15 may also te used to transfer control to 
without ^rfoniiirg initialization. 


5.2 USER I/O TOROCi TRAP #15 

Format in user progran; 

TOAP #15 Call to Taibcg trap hairier 

rc.W $000x Function requests (x « function) 

Valid Fmctions (refer to paragraph 4.2.10 for ^rt nuiter definitions) i 


FU^I« DF^TmTIW 
0 

1 ton»le C^rt 1) 


2 Console (^rt 1) 


3 Itost (^rt 2} 


4 Itost (^rt 2) 


DESCRIPTim 

Display format (see DF) ; then go to TMbi^. 

Input line 

Input iMrairetersi »int A5.L aM A6.L toth to 
the start of buffer. 

Exit corrfitionoi A5.L |»ints to the start of 
buffer; A6.L |»irits to the 
e«3 + 1. 

ttJtput line (with CR, LP) 

Input parameters I Itoint A5.L to start of 
strirq and M.L f 

String + 1. 

Exit eorriitions: ^tone. 

tead line (no echo) 

Input parameters: as Function 1. 

Exit corrfitions: Sane as Fwiction 1. 

Oitput line (with CR, LF) 

Input parameters I ^me as Function 2. 


5 Printer (port 4) ^tpjt line (with CR, LF) 

Input paraieters: Sane as Pwction 2. 
Exit corrfitions: ^ne as Function 2. 

6 tor»le (^rt 1) Oitput line (no CR, LF) 

Input |»raneterss &Tie as Fimction 2. 
Exit cor^itions: as Function 2. 
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9 


R 

o 


C 


D 


Itost (^rt 2) 


Printer (port 4) 


Itost C^rt 3} 


ttost (^rt 3) 


Ifost (^rt 3| 


Printer (^rt 5) 


Printer (port 5) 


&Jtput line (no CR^ LF) 

Input parameters! Same as l\inction 2® 
i t oofm! 3» t Ions ® Same as ion 2 ® 


Print line (no CR, LF) 

Input paraneterss Saae as Fynction 2® 
ESC it corrfitions! S«ie as Function 2® 

Read line (no echo) 

Input farameters! Same as Function 1® 
Exit corditions! Same as Function 1® 

ftjtput line (with CR^ LF) 

Input parameters! S«e as Function 2® 
Exit cor^itions! Sane as Fmction 2® 

Oitput line (no CF, LF) 

Input par«eters! ^me as Function 2® 


print line (with CR, LF) 

Input ^rameters! Same as Function 2# 
Exit cor^itions! Same as Function 2« 


Print line (no CF^ LF) 

Input parameters 1 as Function 2® 


KWLE PR^^ s 

"" "k 

* TEST OF TRAP #15 USER I/O 


002000 

002006 

00200C 

00002000 

2E7C00004000 

2A7C0000201C 

2C4D 

STMT 

^ $2000 
mVE.L #$4000 rA7 
MWE®L #BUPiER,A5 
fWE.L A5,^ 

PITORM STMTS HERE 
INITIALIZE ST^K 

FIX UP A5 & ^ for I/O 

00200E 

002010 

4E4F 

0001 


TRAP #15 

WM 1 

INPUT BUPKR mM CmSOLE 

002012 

002014 

4E4F 

0002 


TRM #15 

2 

PRINT BUPBBR *^0 CttiSOLE 

002016 

002018 

00201A 

4E4F 

0000 

60E4 


TRAP #15 

0 

STOP HERE LIKE BREMPOINT 

e0201C 

0200 

MJFIER 

D6*L 128 

THIS IS THE 1/0 BUFFER 
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APP^IX A 


SOromRE ATORT 


If a target progran must te stop^d with the stack data preserved, the user niay 
press the ABORT pushbutton on the VfW'lO chassis operator ®iis will 
generate a level seven interrupt vector ^ich will interrupt the target pr^ran 
arrf load the contents of location $138 into the program counter^ If the 
default vector locations have not teen overwritten, the console will display 
anmRE ABORT and the following data will te saved i address registers, data 
roisters, prograi counter, status register, su^rvisor stack pointer, user 
stack winter, vector base register, destination function code, and source 
function code® 

Reiwter that Taiteg shares resources with the target pr^rain under test (see 
paragraph 1®3®2)® Ifierefore, if the target program changes the contents of 
location $138, this atort feature is lost® 

In contrast to the abort feature, the contents of the target su^rvisor stack 
pointer, program counter, and status register are lost ^en the RESET pushbutton 
is pressed® Ihe RESET feature sets the processor to su^rvisor state, loads the 
su^rvisor stack |»inter with the contents of RM locations 0-*$3, arrf loads the 
program counter with the contents of RM locations $4”$7® It also saves the 
contents of the target registers for display by the Display Format (DF) comiand® 
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APPQ©IX B 


Ef»R MESS^ES mm OTHER MESS«ES 


ERR« MESSMSE 
PRINTER NOT READY 

SYNTAX ERROR 
ERROR 

ILLffiAL INOTRUCTI« 
imp ERR« 

IS NOT A HK DIGIT 

DATA DID NOT STORE 

IWALID ADmESS 

WHAT 
NOT’ HEX 


MEAMI^C 

Printer is not pro|»rly connects or cannot 
receive output 

Error in coiwand line 

Error (prefix) 

Instruction used an illegal op-code 

See Traps jn MC68010 16-Bit Virtual fcwry 
Microprocessor product speed ficat Son harrf^k 

Improper character ontercxl in a field that 
requires a hexadecimal ciigit 

Data did not go ^ere intend^ (such as 
attemptirq to write to RM) 

Ibo big (1 in bits 24 - 31) or odd for M or 
.L (1 in bit 0) 

Program does not raognize user’s entry 
Same as IS N0r A HEX DIGIT 


OTiER MESSAGE 
x®y > 

mwmmE atort 

BREAK 

AT BRMCPOINT 
PIffSICAL ATORKS 
.PC within “DIBlOiEM” 


M^I« 

prompt 

Displtiyed ^en AB«T button is used 
BREAK key has been us^ 

Indicates progran has stoH»d at breakpoint 
^tual address by romiaiid 
Displayed by trace coiaai^s 






APPMDIX C 


OTFIGyRATIM MEA 


Disks initialize usir^ YERSWos contain a Yoliiie Identification Block art a 
Disk tonfigurition Block in YEi^Mos sectors 0 a«l I, respectively* TBteq 
looks for tee strii^ in locations $re-$FF of sector 0 to validate the 

disk. TM)ijg th®n uses th# follovirq paraiieters fron the Disk tonfiguration 
ilock to access the disks 

Attributes wrd 

Physical sectors per track on iwdia 
M*^r of he^s on drive 
iuitar of cylirders on iwdia 
ftiysical sector siz® of iwdia 
PrecoB^nsation cylirrfer rnjitar 

conplete disk configuration block is showi telows 


YEreWos LBSTi 

SE^W 1 m P^IETER 

OFR’igr BYTES DiCTICTI« 

DE¥IDE STATUS 
01 


1 

2 

3 

4 
6 
8 

10{$A| 
12C$C| 
16 ($10) 
20C$i4) 
24 ($18) 
25C$19| 
26($1A) 
28C$1C) 
29C$1D) 
30($iE) 
32 C$20} 
34 C$22) 
36 ($24) 
38 C$261 
39C$27J 
40 C$28} 


1 


2 

2 

2 

4 

4 

4 

1 

1 

2 

1 

1 

2 

2 

2 

2 

1 

7 

60f$M) 


CmWEL TYPE 
mVICE WPE 
DRIVER C®E 
ATTRIBOTES 
PMMETERS MASK 
ATTRIBOTES 

mm^m SE^m size 

TOTAL VERSMmJ SECT«S 
WITE TIMEaiT C MUSED) 

RE» TiMEow cuaisro) 

PHYSICAL SECrmS PER TRACK m MEDIA 
10. OF HSAK m miVE 
iO. OP CYLI^RS « MTOIA 
INTElLmVE FACTCm M MTOIA 
SPimL OFfBET « MroiA 

pmsi«. sEcitm SIZE or mtoia 

PHYSIC SECim SIZE OF MIVl 
«J»ER OF Cf LINDERS Ol miVE 

PRECOPMSATIOI CfLIireR # fiiSiMlly .5 total cyl) 

Pf»SI»L SECTCmS PER TRM^K 01 miVE 

RESEWro 
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Disks initialized on systems without VERSMos may not contain the yolunie 
Identification Block or the Disk Configuration Block. These disks cannot 
accessed by T®bug imtil the locations $re-'$FF of VERSMos sector 0 are irodifieti 
to contain the string "EXQRMACS”. TEft)ug then uses the following default values 
to access the disk® These default values will allow access of track 0 for all 
configurations ® 
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PARAMETER DESCRIPTIW 

FLWPY 

DISK 

HARD 

DISK 

Attributes «rd 

$0F 

$10 

Physical sectors per track on media 

10 

N/A 

Nuiter of heads on drive 

2 

1 

NMber of cylinders on media 

4F 

1 

Physical sector size of media 

N/A 

N/A 

PrecoEipensation cylinder number 

28 

0 

The attributes word is defin«l as: 



Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 
/0/0/0/MT/SN/DS 

2 Bit 1 
/ MF 

Bit i 
/ TD 


MT - ^tedia Type 

0 » Floppy disk 

1 * Ifard disk 

SN* - Sector Nwibering 

0 * »torola fornBt 

1 * IBM format 

DS* - Diskette Sides 

0 = Sirqlu sided 

1 =5 Ltouble sided 

MF* - Recording Method 

0 * Sir^le data density (FM) 

1 data density 

TV - Track tensity 

0 * Sir^le track density (48 TPI) 

1 * teuble track density (96 TPI) 
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* Floppy Disk attribute only® 


